home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1997 January: Mac OS SDK / Dev.CD Jan 97 SDK2.toast / Development Kits (Disc 2) / OpenDoc Development Framework / ODF-Interest Archive / June 96 / Re ODUtils Unused.1 < prev    next >
Encoding:
Internet Message Format  |  1996-12-03  |  2.0 KB  |  [TEXT/ttxt]

  1. Subject:     Re: ODUtils:Unused
  2. Sent:        6/6/96 3:44 PM
  3. Received:    6/6/96 3:51 PM
  4. From:        Hutchings Software Development, hsd@earthlink.net
  5. Reply-To:    ODF Interest, ODF-Interest@CILabs.ORG
  6. To:          OpenDoc Development Framework Discussion List, ODF-Interest@CILabs.
  7.  
  8. A few weeks ago, Henri wrote about the ODUtils::Unused folder:
  9.  
  10. > The Node class is part of the OpenDoc Utilities. They are a set of
  11. > utilities developed by the OpenDoc team. ODF use internally a small
  12. portion
  13. > of those utilities. Stuff we don't use are in the unused folder. Those
  14. > classes and utilities are not part of the ODF project but they can be
  15. very
  16. > useful. Your are free to use them. The maintenance and development of
  17. those
  18. > utilities is done by the OpenDoc team. They are also available with the
  19. > OpenDoc SDK.
  20.  
  21. Some of these files do not compile when put into an ODF project.
  22. "ODUtils.cpp" for example, complains about OpenDoc "ASSERT" macros. It
  23. would be useful if some layer of ODF took care of matching all the OpenDoc
  24. macros (defined in the unused Utilities) to ODF macros.
  25.  
  26. After inserting all of the files from ODUtils::Unused into an ODF project
  27. (just to test out the compile process), I found just a few compiler errors:
  28.  
  29. (1) Several files use the OpenDoc "ASSERT" macro, which takes two
  30. parameters, a condition and an error number. There are other variations,
  31. like "WASSERT" used as well. Could these be mapped to a new macro
  32. FW_ASSERT_ERROR or existing ODF macros where appropriate?
  33.  
  34. (2) The file Except.cp had problems with redeclared macros, BUT there
  35. should be no conceivable reason to use that file.
  36.  
  37. (3) Printer.r and UtilCmmn.r do not have appropriate #includes, but that's
  38. not ODF's problem, and they shouldn't be needed in any ODF projects.
  39.  
  40. (4) Another macro, "WARN", which is used with Debug OpenDoc.
  41.  
  42.  
  43.  
  44. Suggestion: Maybe in future releases, the ODUtils::Unused could be split up
  45. into ODUtils::Unused and ODUtils::Dont_Use.
  46.  
  47. Brad
  48.  
  49.  
  50. Richard B. "Brad" Hutchings
  51. General Partner,
  52. Hutchings Software Development
  53.  
  54. hsd@earthlink.net
  55.